/*
 * Fichier: FonctionnementException.java
 * Crée le: 23 juin 2007.
 * Modifié: 21 février 2009.
 * Auteurs: Sébastien ESTIENNE.
 * SiteWeb: http://www.prog-info.org/
 * 
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; either version 2 of the License, or
 * (at your option) any later version.
 * 
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 * 
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
 */

package chapitre10;



import java.awt.BorderLayout;
import java.awt.Container;

import javax.swing.JFrame;
import javax.swing.JScrollPane;
import javax.swing.JTextArea;



/**
 * <p>Classe montrant le fonctionnement des exceptions.</p>
 * @author Sébastien ESTIENNE.
 */
public class FonctionnementExceptions extends JFrame
{
   /**
    * <p>Serial version UID.</p>
    */
   private static final long serialVersionUID = 1L;

   /** Zone de sortie. */
   private JTextArea zoneSortie = null;


   /**
    * <p>Construction de l'application.</p>
    */
   public FonctionnementExceptions()
   {
      // Appel du constructeur de la classe JFrame.
      super("Fonctionnement Exceptions");

      // Obtenir le panneau de contenu et changer son layout en un BorderLayout.
      Container conteneur = getContentPane();
      conteneur.setLayout(new BorderLayout());

      // Initialisation des composants de l'interface graphique.
      this.zoneSortie = new JTextArea();
      conteneur.add(new JScrollPane(this.zoneSortie));

      // Test de la méthode lancerException.
      try
      {
         lancerException();
      }
      catch(Exception e)
      {
         this.zoneSortie.append("main : Exception capturée dans le bloc catch.\n");
      }

      // Test de la méthode nePasLancerException.
      this.zoneSortie.append("\n");
      nePasLancerException();

      // Modifie les propriétés de la fenêtre.
      setSize(400, 200);
      setLocation(100, 100);
      setVisible(true);
   }


   /**
    * <p>Méthode permettant d'illustrer le concept try/catch/finally et simulant le lancement d'une
    * exception.</p>
    * @throws Exception L'exception lancée.
    */
   public void lancerException() throws Exception
   {
      // Début de la méthode.
      this.zoneSortie.append("lancerException : Début de la méthode.\n");

      // Lance une exception.
      try
      {
         this.zoneSortie.append("lancerException : Passage dans le bloc try.\n");
         throw new Exception();
      }
      // Capture l'exception et la relance.
      catch(Exception e)
      {
         this.zoneSortie.append("lancerException : Exception capturée dans le bloc catch.\n");
         throw e;
      }
      // Code exécuté qu'une exception soit lancée ou non.
      finally
      {
         this.zoneSortie.append("lancerException : Passage dans le bloc finally.\n");
      }

      // Code inaccessible.
      // this.zoneSortie.append("lancerException : Fin de la méthode.\n");
   }


   /**
    * <p>Méthode permettant d'illustrer le concept try/catch/finally et qui ne lève pas
    * d'exception.</p>
    */
   public void nePasLancerException()
   {
      // Début de la méthode.
      this.zoneSortie.append("nePasLancerException : Début de la méthode.\n");

      // Entrée dans le bloc try.
      try
      {
         this.zoneSortie.append("nePasLancerException : Entrée dans le bloc try.\n");
      }
      // Ce bloc ne s'exécute pas car aucune exception n'est levée.
      catch(Exception e)
      {
         this.zoneSortie.append("nePasLancerException : Mince on est dans le bloc catch!\n");
         this.zoneSortie.append(e.toString());
      }
      // Code exécuté qu'une exception soit lancée ou non.
      finally
      {
         this.zoneSortie.append("nePasLancerException : Passage dans le bloc finally.\n");
      }

      // Fin de la méthode.
      this.zoneSortie.append("nePasLancerException : Fin de la méthode.\n");
   }


   /**
    * <p>Lance l'application.</p>
    * @param args Les paramètres de la ligne de commande.
    */
   public static void main(String[] args)
   {
      new FonctionnementExceptions();
   }
}
